SIGGRAPH 1996: Proceedings

home *** CD-ROM | disk | FTP | other *** search

/ SIGGRAPH 1996: Proceedings / SIGGRAPH 1996: Proceedings.iso / pc / acrobat / v1 / sgi / readme.rdr < prev next >

Wrap

Text File | 1995-07-08 | 16.9 KB | 429 lines

ADOBE(TM) ACROBAT(TM) READER Release Notes for Version 1.0.1 for Silicon Graphics(TM) IRIX(TM) 5.3 This file contains brief installation instructions, important last- minute product information, program errors not covered in the documentation, and summaries of known problems and limitations. It also addresses some configuration and performance issues. Other than this README file, all other documentation for this product is available from the Help menu or in the doc directory that is part of the distribution. Depending on how you received this product, there might be an installation guide in PostScript or PDF format that is part of the distribution. Product Information: Electronic End User License Agreement Installing Adobe Acrobat Reader Launching Adobe Acrobat Reader Installing Man Pages Command Line Printing Command Line Conversion From PDF to PostScript Automatic Extraction of PDF Files from Mail Messages Known Problems: UNIX Problems With Novell Servers Occasional Difficulties with Certain Fonts Product Limitations: File Loading Limitations Printing Limitations Text Selection Text Greeking No APIs with Version 1.0.1 Command Line: One Bad File Can Prevent Others From Loading Configuration and Performance Issues: Multiple Versions of DPS/NX May Be Installed Viewing 24-bit Images Performance Problems with Type 3 Fonts / TeX Default Page Size Slow Menus When Displayed from HP Workstations ==================== PRODUCT INFORMATION ======================== ELECTRONIC END USER LICENSE AGREEMENT ------------------------------------- This version of Adobe Acrobat Reader contains an Electronic End User License Agreement that appears the first time a given user attempts to run the software. Do not run the Software unless you have read and accepted the terms of the license agreement. You indicate that you accept the terms of the license by entering the word "ACCEPT" in response to a run-time prompt. A copy of the license agreement can be found in: <installdir>/AcroRead_1.0.1/LICENSE (<installdir> is /usr/adobe by default). INSTALLING ADOBE ACROBAT READER ------------------------------- If you have a hardcopy installation guide, you should follow the instructions in that document to install Adobe Acrobat Reader. Alternatively, if there is a PostScript (.ps) version of the installation guide included in the distribution, either print that file to a PostScript printer or view the file with a PostScript viewer such as xpsview or Adobe ShowPS(TM). If you have neither a hardcopy nor an electronic version of the installation guide, then here are some brief instructions for installing Adobe Acrobat Reader: Certain CD-ROMs are multi-platform and have multiple Acrobat Readers (e.g., Macintosh, Windows and UNIX versions). Under IRIX 5.3, some of these multi-platform CD-ROMs will mount as Macintosh (i.e., hfs) volumes rather than ISO9660, which prevents the installation scripts from working. (You can tell that a CD-ROM has been mounted as an hfs volume if you find .HSancillary directories within the mounted CD-ROM or if you find that execute priveleges are not present for the easyinst.rdr or install.rdr scripts.) For multi-platform CD-ROMs, you need to mount the CD-ROM in a special way: % su root Password: # /usr/etc/mediad -k # /sbin/mount -o ro -t iso9660 /dev/scsi/sc0d4l0 /CDROM (Substitute the SCSI id# from the back of your CD-ROM drive for the "4" in "/dev/scsi/sc0d4l0".) Then you can "cd" to /CDROM and find the SGI Reader installation scripts. After installing, turn the media daemon back on: # cd / # /usr/etc/mediad -a To eject the CD-ROM, try the command "eject /CDROM" or manually eject the CD-ROM. There are two installation scripts that accompany most distributions: easyinst.rdr and install.rdr. easyinst.rdr is usually best suited for local (i.e., single-system) installations, whereas install.rdr is usually best suited for custom installations, particularly when you are installing Adobe Acrobat Reader on a network (i.e., NFS) volume. easyinst.rdr will place the Adobe Acrobat Reader software (AcroRead_1.0.1) and Display PostScript NX software (DPSNXBasic_2.1.1) in the location (<installdir>) that you request. The default <installdir> is /usr/adobe. After copying the software onto your system, easyinst.rdr will automatically create symbolic links as follows: /usr/bin/acroread -> <installdir>/AcroRead_1.0.1/bin/acroread /usr/bin/dpsnx.agent -> <installdir>/DPSNXBasic_2.1.1/bin/dpsnx.agent Also, easyinst.rdr will register Acrobat Reader program and PDF file icons with the Indigo Magic desktop. easyinst.rdr does not prompt you for a list of directories where you store the *.upr files that point to your Type I fonts; instead, it assumes that the *.upr files can be found in /usr/psres or $HOME/psres. install.rdr will place the Adobe Acrobat Reader software (AcroRead_1.0.1) and Display PostScript NX software (DPSNXBasic_2.1.1) relative to the <installdir> that you request. The default <installdir> is /usr/adobe. install.rdr will not create symbolic links in /usr/bin automatically, nor will it register icons with the Indigo Magic desktop. install.rdr will prompt you for a list of directories other than /usr/psres and $HOME/psres where it should look for *.upr files that point to your Type I fonts. If you use install.rdr, it creates a file called /tmp/acroread.makelinks which you can run immediately after install.rdr to create symbolic links for acroread and dpsnx.agent. Alternatively, you can create symbolic links by running the makelinks scripts within each of the installscripts directories for AcroRead_1.0.1 and DPSNXBasic_2.1.1. To register icons with Indigo Magic, you can run <installdir>/AcroRead_1.0.1/desktop/deskinstall. LAUNCHING ADOBE ACROBAT READER ------------------------------ In most installation cases, the Acrobat Reader icon will be installed on the desktop at installation time. In particular, if you installed Acrobat Reader using the SGI software manager or using a script called easyinst.rdr, the desktop icon will be installed automatically. If you installed Acrobat Reader using a script called install.rdr, then the icon may not necessarily be installed on your desktop. If the icon has not been installed, please run the script: <installdir>/AcroRead_1.0.1/desktop/deskinstall to install the desktop icon. Once the install is complete, you may invoke Acrobat via: a) double-clicking on the desktop Acrobat icon b) double-clicking on a desktop PDF file icon c) typing 'acroread' to a UNIX shell, provided that the directory containing the acroread launch script (default: /usr/bin) is in your PATH shell variable. Note, in addition you may obtain help on 'acroread' by typing either of the following at a UNIX shell. a) acroread -help b) man acroread INSTALLING MAN PAGES -------------------- In some installation cases, man pages will be installed automatically when you install the Acrobat Reader software; in other cases, the man pages will not be installed automatically. If man pages are not installed automatically, then you will need to refer your system documentation for how to install the unformatted man pages that are part of the Acrobat Reader distribution. Most of the information found on the man page is also available by typing "acroread -help". COMMAND LINE PRINTING --------------------- You can print PDF files from the command line if you are running the X Window System. To learn how, type either of the following at a UNIX shell: a) acroread -help b) man acroread COMMAND LINE CONVERSION FROM PDF TO POSTSCRIPT ---------------------------------------------- You can convert PDF files to PostScript from the command line if you are running the X Window System. To learn how, type either of the following at a UNIX shell: a) acroread -help b) man acroread AUTOMATIC EXTRACTION OF PDF FILES FROM MAIL MESSAGES ---------------------------------------------------- Adobe Acrobat Reader 1.0.1 has the ability to extract uuencoded or in-line PDF files from many types of mail messages. If you can save the mail message to a <file>, then often you can load the <file> from a running Acrobat Reader or you can issue the command "acroread <file>". This feature can sometimes be used to invoke Acrobat Reader directly from mail programs. =================== KNOWN PROBLEMS ============================= UNIX PROBLEMS WITH NOVELL SERVERS --------------------------------- Novell Netware servers may exhibit generic file access problems between Mac/Windows clients and UNIX/NFS clients where a file opened by a Mac or Windows user cannot be opened by a UNIX user or vice-versa, even if the file is opened read-only and permissions appear to give universal access. An alert may appear that says: Unable to read file. Permission denied. This message may appear even if ls -l indicates -rw-rw-rw permissions on the file. When this situation occurs, even standard UNIX command such as more and wc cannot open this file, not just Acrobat. The only known workarounds are to wait for the Macintosh/ Windows users to close the file (there is a timeout component where you might have to wait some number of seconds) or copy the file from a Macintosh or Windows machine to another location which will only be opened by UNIX users. OCCASIONAL DIFFICULTIES WITH CERTAIN FONTS ------------------------------------------ There is a known problem with the software with certain classes of fonts which may occasionally prevent the application from viewing/printing particular pages. The problem is rather obscure and will not be encountered by most users. If you find that you cannot view/print a particular page, try the following: 1) Add the following line to the appropriate start-up file in your home directory (e.g., .cshrc if you are using C-shell): setenv PSRESOURCEPATH <installdir>/AcroRead_1.0.1/fonts:: For example, if Reader was installed in the default location of /usr/adobe/AcroRead_1.0.1, then the line would read: setenv PSRESOURCEPATH /usr/adobe/AcroRead_1.0.1/fonts:: 2) Log out of your workstation and then log back in to make sure that all of your shell windows will have environment variable PSRESOURCEPATH set correctly. 3) Try to view/print the problem page again. ================== PRODUCT LIMITATIONS ========================= FILE LOADING LIMITATIONS ------------------------ This version 1.0.1 of Adobe Acrobat Reader cannot read all PDF version 1.1 files, particularly when these files contain Acrobat 2.0 constructs such as document security. Also, this Reader may not be able to read files that have large amounts of graphics on a single page. PRINTING LIMITATIONS -------------------- This version 1.0.1 of Adobe Acrobat Reader will not always print successfully on certain printers, particularly printers driven by Impressario(TM) or printers with small amounts of memory that do not support PostScript Level 2. If your files don't print and you have a Level 1 PostScript printer, make sure that you have Level 1 selected in the Print dialog. If you encounter problems, such as a "VMerror," printing to output devices supporting the Adobe PostScript language, it may be because the printer has little available memory (for example, a non-upgraded LaserWriter, LaserWriter Plus, LaserWriter II NT or NTX). There are two potential solutions to this problem: 1. In the Preferences dialog (select from the Edit menu) you may choose to use Serif only or Sans only for font substitution. This frees up additional memory in the printer and chances are your document will print successfully. 2. The other option is to purchase more memory for your printer. If you are using an Apple Personal LaserWriter NT printer that has not been upgraded to a Personal LaserWriter NTR, Acrobat Reader will not be able to print substitute fonts. Contact your Apple dealer for information on upgrading your printer. TEXT SELECTION -------------- Unexpected Results may occur using the text select tool. This is an inherent consequence of the way the text appears in the PDF file. Make sure the text selection marquee intersects only with the desired text. TEXT GREEKING ------------- Type 3 fonts do not greek. NO APIs with VERSION 1.0.1 -------------------------- Acrobat version 1.0.1 does not support any application programming interfaces except via the command line. The command line interface consists of: acroread <files>... A new invocation of Acrobat Reader is launched to load/display the given files. COMMAND LINE: ONE BAD FILE CAN PREVENT OTHERS FROM LOADING ---------------------------------------------------------- If you attempt to launch Acrobat Reader with a command such as: acroread * If any of the specified files is not a valid PDF file, then all subsequent files may not be loaded. The work-around: only ask Acrobat Reader to load valid PDF files. ============ CONFIGURATION AND PERFORMANCE ISSUES ================ MULTIPLE VERSIONS OF DPS/NX MAY BE INSTALLED --------------------------------------------- Acrobat Reader 1.0.1 for Silicon Graphics includes Display PostScript NX version 2.1.1. Other Adobe software products for Silicon Graphics (e.g., Adobe Illustrator 5.5 and Type On Call 4.0.1) include an older version 2.1. Version 2.1.1 is only differentiated from version 2.1 by a fix for an obscure Acrobat-related bug. Installing a product such as Adobe Illustrator 5.5 and Acrobat Reader 1.0.1 will result in both versions of DPS/NX being installed on your system. If you have both versions DPSNXBasic_2.1 and DPSNXBasic_2.1.1 installed in your installation directory (/usr/adobe/by default), remove the older version by deleting the DPSNXBasic_2.1 directory. If you installed Adobe Illustrator 5.5 after Acrobat Reader 1.0.1, you will also need to update the symbolic link /usr/bin/dpsnx.agent to the 2.1.1 version since the 2.1 installation will have overwritten it. To do this, as root, if there is a makelinks script in the DPSNXBasic_2.1.1/installscripts directory, run this script and accept the default prompts. If there is not an installscripts directory or it does not contain a makelinks script, then, as root, you will have to manually create the link as follows: rm /usr/bin/dpsnx.agent ln -s /usr/adobe/DPSNXBasic_2.1.1/bin/dpsnx.agent /usr/bin/dpsnx.agent Failure to make the symbolic link will keep Acrobat Reader from launching and will print the following Acrobat Reader Alert message "Cannot create a dps context". An error message will also be printed to the console or the shell window that Acrobat Reader was launched from: %% DPS Client Library Warning: FAILED to auto-launch: dpsnx-agent -debug 0 VIEWING 24-BIT IMAGES --------------------- Acrobat Reader launches using the default visual for your windowing systems. Thus, if your default visual is 8-bit, then Acrobat Reader will display images using 8-bit graphics even on a 24-bit system, using dithering operations to approximate correct display of graphics. If you wish to view 24-bit images in 24-bit mode on your SGI (assuming you have 24-bit hardware), you need to become root, add the options "-depth 24 -class TrueColor" to your /usr/lib/X11/xdm/Xservers file, and run /usr/gfx/stopgfx (this will kill all of your active windows and your X server). You will then get a console window with a login prompt. Login as root and issue the command /usr/gfx/startgfx to restart the X server and Indigo Magic. PERFORMANCE PROBLEMS WITH TYPE 3 FONTS / TeX -------------------------------------------- Some tools, such as TeX, may generate Type 3 bitmap fonts to render text to PostScript devices. The PDF files produced by distilling the PostScript output of these tools with Acrobat Distiller will display slowly under Acrobat Reader. If you set up your version of TeX to substitute Type 1 fonts for TeX fonts when generating PostScript, then the PDF files produced from that PostScript will display much faster in Acrobat. DEFAULT PAGE SIZE ----------------- Adobe Acrobat Reader defaults to the size of the first page of a document. To change the default, you can edit the X resource file Acroread located in the first directory in your XUSERFILESEARCHPATH (if this environment variable has a value), or in the XAPPLRESDIR directory (if this environment variable has a value), or in your home directory. Add the following line (make sure not to leave spaces): *pageViewShell.geometry: wxh w is the width of the window; h is the height. SLOW MENUS WHEN DISPLAYED FROM HP WORKSTATIONS ---------------------------------------------- When you run the product on an SGI workstation but display on an HP workstation, the Motif menus within Reader are slower than other similar Motif applications. Copyright 1995 Adobe Systems Incorporated. All rights reserved. Adobe, Adobe Acrobat, PostScript and Display PostScript are trademarks of Adobe Systems Incorporated which may be registered in certain jurisdictions. Silicon Graphics is a registered trademark and IRIX is a trademark of Silicon Graphics, Inc. UNIX is a registered trademark of UNIX System Laboratories, Inc., a wholly owned subsidiary of Novell, Inc. Motif is a trademark of Open Software Foundation.